home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / msatcm.zip / MSATENG.DOC < prev    next >
Text File  |  1991-10-03  |  17KB  |  491 lines
  1. (*****************************************************************************)
  2. (*                                                                           *)
  3. (*             MSATCOM(tm) - MicroSat Ground Station Terminal                *)
  4. (*                                                                           *)
  5. (*                              Version 1.0                                  *)
  6. (*                                                                           *)
  7. (*            (c) Copyright 1990 by Claudio M. Zanella LU4AEY                *)
  8. (*                     Released For Public Distribution                      *)
  9. (*                           ALL RIGHTS RESERVED                             *)
  10. (*                                                                           *)
  11. (*****************************************************************************)
  12.  
  13.     USE
  14.  
  15.     Digital communications protocol FTL0 (File Transfer Level 0)
  16.  
  17.  
  18.     SOFTWARE REQUIRED
  19.  
  20.     - MSATCOM.EXE    Main program (english version)
  21.     - README.COM     Program to read file THUNDER.DOC
  22.     - MSATCOM.DOC    User documentation in Spanish
  23.     - MSATENG.DOC    User documentation in English (this document)
  24.     - MSATCOM.CNF    System configuring file
  25.  
  26.     HARDWARE REQUIRED
  27.  
  28.     MSATCOM can be used on PC, XT, AT and Compatibles. It requires for its 
  29.     functioning TNCs with TAPR type commands and the complete connection of 
  30.     the RS232 port, fit 1,2,3,4,5,6,7,8,20.  Take special care in fitting: 
  31.     8 (Data Carrier Detect), 4 (Request to Send), 5 (Clear to Send). 
  32.  
  33.     With a PacComm TNC 220 & 320 set JP-C to CONN (Default is HIGH)
  34.  
  35.     The addition of the following in your CONFIG.SYS file is recommended: 
  36.  
  37.     FILES = 20
  38.     BUFFERS = 20
  39.  
  40.     MSATCOM was tested with the following HARDWARE:
  41.  
  42.     TNC types:
  43.  
  44.     PACCOMM TINY 2
  45.     PACCOMM TNC 200
  46.     PACCOMM TNC 220
  47.     PACCOMM TNC 320
  48.     MFJ-1270/1278
  49.     AEA PK 232
  50.     AEA PK88
  51.  
  52.     Computer types:
  53.  
  54.     PC AT 80386   20/25 MHz
  55.     PC AT 80286   16/20 MHz
  56.     PC AT 80286   12/16 MHz
  57.     PC XT 80286    8/12 MHz
  58.     PC XT 8088     4/10 MHz       PC XT NEC V20 10/12 MHz
  59.  
  60.     SETTING THE TNC
  61.  
  62.     This programm uses Hardware Handshaking.   Set its TNC on NO PARITY and 
  63.     WORD LENGTH OF 8 BITS. 
  64.  
  65.     CPactime OFF
  66.     CR       ON
  67.     SEnd     $0D
  68.     DCD      ON  <-- External Carrier Detect in PK232
  69.  
  70.     Enable the Hardware Handshaking of your TNC as follows:
  71.  
  72.     START  0
  73.     STOP   0
  74.     XFLOW  OFF
  75.     XON    0
  76.     XOFF   0
  77.  
  78.     The following parameters are recommended:
  79.  
  80.     TXDEALY 20
  81.     AXDELAY 20
  82.     PRIOACK ON <-- Release TAPR 1.1.7 only
  83.     FLOW    ON
  84.  
  85.     SUMMARY OF COMMANDS
  86.  
  87.     The following commands can be used in MSATCOM:
  88.  
  89.     F1         - Request reception of directories.
  90.     F2         - Request reception of files (DOWNLOAD).
  91.     F3         - Request send files (UPLOAD).
  92.     F4         - Activate/De-activate the printer in Directory mode.
  93.     F5         - Review downloaded directories by screens.
  94.     F6         - Adjust time of General directories request (HIGHTIME..PG).
  95.     F7         - Adjust time of Personal directories request (HIGHTIME.MY).
  96.     F8         - Adjust time of Bulletin directories request (HIGHTIME.BUL).
  97.     F9         - Change the current satellite.
  98.     F10        - Gateway to DOS.
  99.  
  100.     Alt-B      - Send of break signal to TNC to put it into command mode.
  101.     Alt-D      - Change level of Data Carrier Detect (DCD pin 8 v24).
  102.     Alt-H      - Help screen (HELP).
  103.     Alt-R      - Re-organize directory files.
  104.     Alt-T      - Toggle modes: Terminal or Server.
  105.     Alt-X      - End MSATCOM (Return to DOS).
  106.  
  107.     DESCRIPTION OF USE OF COMMANDS
  108.  
  109.     KEY F1 (DIRECTORY):
  110.  
  111.     By pressing F1 you get to DIRECTORY options.  There are four options 
  112.     for the mode: 
  113.  
  114.     ALL      -  Receive the File Headers since last request.
  115.     PERSONAL -  Receive the File Headers sent to 'mycall' since last request
  116.     BULLETIN -  Receive the File Header sent to 'ALL' since last request
  117.     SEARCH   -  Receive the File Header that contains the search criterion 
  118.                 specified by you taking as reference the time since the 
  119.                 last request to ALL. 
  120.  
  121.     To correct the times since the last request (hightime.xx), see options 
  122.     F6, F7 and F8;  these are contained in files MSTIME.ALL, MSTIME.MY and 
  123.     MSTIME.BUL in UNIX Hexadecimal format. 
  124.  
  125.  
  126.     KEY F2 (DOWNLOAD):
  127.  
  128.     Through this key we DOWNLOAD.  Its use is very simple and consists of 
  129.     indicating the HEXADECIMAL number of the file we are interested in 
  130.     receiving. 
  131.  
  132.     This will be memorized until the DOWNLOAD concludes, satisfactorily or 
  133.     not.  If by any chance the DOWNLOAAD of the file did not end and the 
  134.     contact with the server is lost, the next time the satellite is in view 
  135.     press F2 and the programm will automatically reinitiate the DOWNLOAD 
  136.     from the offset where it lost contact. 
  137.  
  138.     ATTENTION: this will repeat as long as the program doesn't receive the 
  139.     COMMAND DATA END or the DOWNLOAD_ERR_RESP that gets you off the PDL 
  140.     status to the DOWNLOAD file.  If you want to abort this download 
  141.     request, ERASE from your DOS the current DOWNLOAD file. 
  142.  
  143.     File status:
  144.  
  145.     xxxxxx.PDL   : File being downloaded (This hasn't ended).
  146.     xxxxxx.DL    : File downloaded successfully
  147.     xxxxxx.XDL   : Rejected file (An error occurred during the download).
  148.  
  149.     xxxxxx       : Hexadecimal number of requested file.
  150.  
  151.     KEY F3 (UPLOAD):
  152.  
  153.     By pressing this option you can UPLOAD -- sending of FTL0 format 
  154.     files -- to the server of the Micro satelite.  As with DOWNLOADs, the 
  155.     option UPLOAD remains memorized until it concludes satisfactorily or 
  156.     not. 
  157.  
  158.     If the sending is incomplete because the contact with the server was 
  159.     lost, we can reinitiate the upload from the offset where the process 
  160.     has been interrupted the next time the satellite is in view. 
  161.  
  162.     The UPLOAD is immediate.  Once thithe programm s option is chosen, 
  163.     initiates the connection procedureif files to be 
  164.     sent are found, . 
  165.  
  166.     File status:
  167.  
  168.     mmmmmm.OUT   :  File in initial process of sending.
  169.     xxxxxx.PUL   :  File in process of sending (It has been interrupted).
  170.     xxxxxx.UP    :  File has been uploaded successfully.
  171.     xxxxxx.XUL   :  Rejected file, an error occurred during uploading.
  172.     mmmmmm       :  Initial name of file.
  173.     xxxxxx       :  Hexadecimal number assigned by the server
  174.  
  175.     KEY F4 (PRINTER TOGGLE):
  176.  
  177.     This option enables to put the printer on or offline.  The same will be
  178.     used during the DIRECTORY procedure, this means we can obtain a copy on
  179.     paper of the directory of the server while we are receiving it, by this
  180.     the DOWNLOAD operation is greatly speeded up.
  181.  
  182.     KEY F5 (RELOAD/REVIEW DIRECTORY):
  183.  
  184.     The function of this option is to enable to load and sort  (Reorganize)
  185.     on memory the directories received from the current server, at the same
  186.     time they are shown on screen from the newest to the oldest.
  187.  
  188.     By the keys PageUp and PageDwn you can skip these directories pagewise.
  189.     By the keys UP and  DOWN we can go up  of down by lines.   The HOME key
  190.     positions the screen at  the beginning of the  directory.  The End  key
  191.     positions the screen at the end of the directory.  The W key enables to
  192.     save the screen directories on a file.
  193.  
  194.     The messages directed  to our licence  will be highlighted  to indicate
  195.     the presence of these on list.
  196.  
  197.     A subprocess  is executed  while running  this option.   It consists in
  198.     loading the diretories on a sublist.
  199.  
  200.     This  subprocess  assures  that  the  File  Header  received during the
  201.     DIRECTORY process are  not repeated, so  that no duplicate  directories
  202.     are generated.  If the  presence of a duplicate directory  is detected,
  203.     this is indicated on screen but is not saved on the master file.
  204.  
  205.     KEYS F6, F7, F8 (TIME ADJUSTMENT):
  206.  
  207.     From these options depend the times of request of directories.  MSATCOM
  208.     performs all directory requests taking as reference the present time in
  209.     the MSATCOM.BUL, MSATCOM.ALL or MSATCOM.MY files.
  210.  
  211.     These  files  will  be  updated  after  having  concreted  a request of
  212.     directory, for this the time of  the last File Header in the  server is
  213.     taken as reference.
  214.  
  215.     Once updated, this time can be  altered by these options.  It  consists
  216.     in indicating the program the difference in hours of our GMT hour.
  217.  
  218.     The format  of these  files is  HEXADECIMAL and  corresponds to time in
  219.     UNIX.  The  same will be  created for the  first time by  the programm,
  220.     taking as reference the present time of the programm.
  221.  
  222.     KEY F9 (CHANGE COURRENT SATELLITE):
  223.  
  224.     This  option,  of  immediate  access,  enables  to change instantly the
  225.     current satelite of the program.
  226.  
  227.     In this way the configuration of the program can be changed for the new
  228.     satelite without  leaving it  to perform  changes to  the configuration
  229.     file by loosing time and making it's use complex.
  230.  
  231.     KEY F10 (DOS GATEWAY):
  232.  
  233.     Enables  to  performa  a  DOS  shell  to  execute  external commands of
  234.     programs to MSATCOM.
  235.  
  236.     KEY ESC (ABORT & DISCONNECT):
  237.  
  238.     This key enables to abort any operation started immediately  performing
  239.     a total resetting of the status of variables of the program.
  240.  
  241.     KEY ALT-B (SEND BREAK):
  242.  
  243.     Enables to send a break signal of  350 ms when we are in terminal  mode
  244.     with the target of putting the TNC in COMMAND mode.
  245.  
  246.     KEY ALT-D (DCD LEVEL):
  247.  
  248.     Enables  to  change  the  logical  state  of  the  DCD, this option was
  249.     introduced to enable the TNC's use which use as VALID DCD a high state,
  250.     being the Low state the commonly encountered in the TNC's.
  251.  
  252.     KEY ALT-H (HELP SCREEN):
  253.  
  254.     This option gives us access to a small onscreen help of the commands of
  255.     the programm.
  256.  
  257.     KEY ALT-R (REBUILD DIRECTORY):
  258.  
  259.     Used to reorganize the directory file of the current satelite.
  260.  
  261.     This reorganization consists in cleaning the file directory of possible
  262.     duplicate directories by erasing at the same time the old ones after an
  263.     amount of days we indicate.
  264.  
  265.     KEY ALT-T (TERMINAL/SERVER MODE):
  266.  
  267.     By  this  option  we  can  switch  from  mode  SERVER  to mode TERMINAL
  268.     instantly and quickly.
  269.  
  270.     KEY ALT-X (EXIT TO DOS):
  271.  
  272.     End the execution of MSATCOM (Return to DOS).
  273.  
  274.                                    --- ** ---
  275.  
  276.                      Configuration of file MSATCOM.CNF
  277.                      -------------------------------------
  278.  
  279.     As we saw at the beginning,  this file is in charge of  configuring the
  280.     system, it is  divided in four  sections (Serial SetUP,  Misc Function,
  281.     Top_Cmd_Start/End_Cmd_Setup  y  Top_Cmd_End/End_Cmd_Setup).   The first
  282.     and second one serve to send different commands to the proper  programm
  283.     and the others have as mission to send commands to the TNC to set it in
  284.     its initial and by leaving the program, the last ones can be configured
  285.     by the user.
  286.  
  287.                               Typical configuration
  288.                               ---------------------
  289.  
  290.     In the first  section (Serial SetUP)  we find as  start the setting  of
  291.     speed for  communication of  the computer  to the  TNC, it is necessary
  292.     that both coincide in this speed, the  TNC in this case must be set  on
  293.     9600 Baud.  The length of  word, parity and the stop bit  must coincide
  294.     with the previous setting of the TNC.  There are three options for  teh
  295.     Handshake  and  these  are  the  following:   H (hardware, RTS/CTS) , S
  296.     (software, XON/XOFF) y N (none).  The recommended is the Hardware.
  297.  
  298.     It is also possible  to set the communications  port to be used  in our
  299.     computer by the option Com_Port and it is necessary to do it indicating
  300.     an hexadecimal number, attaching in the following setting (IRQ_Com) the
  301.     corresponding interruption number, for example:
  302.  
  303.                               Port 1 = $03f8  IRQ4
  304.                               Port 2 = $02f8  IRQ3
  305.                               Port 3 = $03e8  IRQ4
  306.                               Port 4 = $02e8  IRQ3
  307.  
  308. #
  309. #              MSATCOM version 1.0  --  Configuration FILE  --
  310. #
  311. # Serial SetUP
  312. #
  313. #
  314. Baud_Rate   = 9600
  315. #
  316. Word_Lenght = 8
  317. #
  318. Parity      = N
  319. #
  320. Stop_Bit    = 1
  321. #
  322. Handshake   = H
  323. #
  324. Com_Port    = $03F8
  325. #
  326. IRQ_Com     = 04
  327. #
  328. #
  329.  
  330.     In the second section (Misc Function), we have both first  instructions
  331.     that correspond to the  tipe of video plate  that is used normally  Not
  332.     and Yes  are the  most used,  but sometimes  it is  necessary to change
  333.     NOT/YES for a better functioning depending on the video plate.
  334.  
  335.     SYSOP_NAME:  as the word says, it is necessary to indicate the name  of
  336.     the system operator.
  337.  
  338.     MYCALL: operator license.
  339.  
  340.     GMT_ZONE:  thought to be used by the program with universal coordinated
  341.     time, taking for it the computer  hour, therefore we must take care  to
  342.     maintain the hour of our machine  and in this case we must  indicate if
  343.     our station is east of west of Greenwich as follows:  EST o WES
  344.  
  345.     GMT_HOURS:  this command operated parallel to the aforementioned and it
  346.     is necessary to  indicate the time  difference that exists  between our
  347.     QTH and the Greenwitch time allways in positive numbers.
  348.  
  349.     SATELLITE:  The  license of the  satelite to which  we want to  connect
  350.     must be  put, without  omitting the  number that  corresponds after the
  351.     dash  and  in  this  case  it  is  number  12,  that for all satellites
  352.     identifies the BBS during the  execution of the program can  be changed
  353.     of  satellite  (F9)  withouth  changing  the  configuration  DCD_LEVEL:
  354.     logical level of the DCD L (low) or H (high)
  355.  
  356.     SORT_TYPE:  This instruction  is used by the  option F6 to perform  the
  357.     classification of the directory, in  this case it will be  performed by
  358.     time (TIME), this means it will be seen on screen since the most recent
  359.     date to the oldest.  It is also possible to make the classification  by
  360.     another parameter, for example SIZE (size).
  361.  
  362.  
  363. # Misc Function
  364. #
  365. #
  366. Snow_Check    = Not
  367. #
  368. Direct_Video  = Yes
  369. #
  370. #
  371. Sysop_Name    = Ruben
  372. #
  373. Mycall        = LU6DYD
  374. #
  375. GMT_ZONE      = EST
  376. #
  377. GMT_HOURS     = 3
  378. #
  379. SATELLITE     = SIMSAT-12
  380. #
  381. DCD_LEVEL     = L
  382. #
  383. SORT_TYPE     = TIME
  384. #
  385. #
  386.  
  387.     In the third section we have  possibility to put the TNC parameters  we
  388.     think adecuate to send at starting the program.  These parameters  will
  389.     be sent automatically to the TNC and can be modified by the user for  a
  390.     better operation with the satellite
  391.  
  392.  
  393. *** Top_Cmd_Start
  394. #
  395. #
  396. FULLD ON
  397. FRAC 2
  398. CONOK OFF
  399. MAX 7
  400. PAC 255
  401. TXD 25
  402. AXD 25
  403. UN SIMSAT V SIMSAT-1
  404. BT SIMSAT Earth Simulator of Micro Satellites - Buenos Aires ARGENTINA.
  405. B E 5
  406. M ON
  407. CONMODE TRANS
  408. #
  409. *** End_Cmd_Setup
  410. #
  411.  
  412.     In the fourth section it is  identical to the third but the  parameters
  413.     are  sent  to  the  TNC  when  we  get  off  the  program (ALT-X) These
  414.     parameters can also be modified by  the user mainly those that use  the
  415.     same TNC for satellites operation and earth
  416.  
  417.  
  418. #
  419. *** Top_Cmd_End
  420. #
  421. #
  422. FULLD OFF
  423. CONMODE CONVERSE
  424. MCOM ON
  425. UN CQ
  426. B E 0
  427. BT %
  428. CONOK ON
  429. MON OFF
  430. #
  431. *** End_Cmd_Setup
  432. #
  433.  
  434.                                    --- ** ---
  435.  
  436.     ERROR REPORT
  437.  
  438.     Due to that the programm is  still being developed, it may be  possible
  439.     that some error occurs.  If  this happens, please pay attention to  the
  440.     following:
  441.  
  442.     Some error in the momento of execution make that the program visualizes
  443.     an error message and ends.
  444.  
  445.     Run time error: nnn at xxxx:yyyy
  446.  
  447.     nnn       : Number of error.
  448.     xxxx:yyyy : Location of error (segment and displacement).
  449.  
  450.     The errors in time of running are divided in 4 types:
  451.  
  452.     Errors of D.O.S.               : Del 1 al 99.
  453.     Errors of Entrance/Exit (I/O)  : Del 100 al 149.
  454.     Critical Errors                : Del 150 al 199.
  455.     Fatal Errors                   : Del 200 al 255.
  456.  
  457.     Please take note of this information and send it so as to evaluate  and
  458.     correct the possible error.
  459.  
  460.            --------------------------------------------------------
  461.  
  462.                               *** ATENTION ***
  463.  
  464.     Ham Radio:
  465.     -----------
  466.  
  467.     For the distribution no charge is asked.  If you are owner of  MSATCOM,
  468.     please let me know so as to keep a statistic of use as well as any type
  469.     of error you may detect or suggestions to improve it.
  470.  
  471.     Therefore, please mail via Packet Radio to:
  472.  
  473.     LU4AEY @ LU4AEY.#VDP.ARG.SA Claudio M. Zanella
  474.  
  475.     By satellite:
  476.  
  477.     LU4AEY @ UOSAT3, PACSAT, LUSAT
  478.  
  479.     By mail to:
  480.  
  481.     Claudio  M.  Zanella
  482.     Av. Alvarez Jonte 3353 Piso 1 Dto  2  Villa del Parque
  483.     CP (ZIP) 01407 Buenos Aires - ARGENTINA. TE: 001-01-567-1239.
  484.  
  485.                              * * * * * * * *
  486.  
  487.     ENJOY IT!
  488.  
  489.                       ...  Claudio
  490. 
  491.